package com.software.task.service;





import com.software.task.pojo.Category;

import java.util.List;

/**
 * 分类服务接口
 *
 * @author 周昊
 * @since 2024/12/16 11:34
 * @version 1.0
 */
public interface CategoryService {
    /**
     * 新增分类
     *
     * @param category 要新增的分类对象
     * @throws RuntimeException 如果新增分类时发生错误
     */
    void add(Category category);

    /**
     * 列表查询
     *
     * @return 分类对象列表
     * @throws RuntimeException 如果查询分类列表时发生错误
     */
    List<Category> list();

    /**
     * 更新分类
     *
     * @param category 要更新的分类对象
     * @throws RuntimeException 如果更新分类时发生错误
     */
    void update(Category category);

    /**
     * 删除分类
     *
     * @param id 要删除的分类ID
     * @throws RuntimeException 如果删除分类时发生错误
     */
    void delete(Integer id);

    /**
     * 根据ID删除分类，同时删除与该分类相关的选课信息
     *
     * @param id 要删除的分类ID
     * @throws RuntimeException 如果删除分类或选课信息时发生错误
     */
    void deleteById(Integer id);

    /**
     * 检查是否存在由指定用户创建且具有指定任务ID的分类
     *
     * @param createUser 创建分类的用户ID
     * @param taskId 分类关联的任务ID
     * @return 如果存在则返回true，否则返回false
     * @throws RuntimeException 如果检查分类时发生错误
     */
    boolean existsByCreateUserAndTaskId(Integer createUser, Integer taskId);

    /**
     * 检查指定用户是否为学生
     *
     * @param userId 用户ID
     * @return 如果用户是学生则返回true，否则返回false
     * @throws RuntimeException 如果检查用户角色时发生错误
     */
    boolean isStudent(Integer userId);
}
